home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / sound / players / swav02.lzh / SWAV.TXT < prev    next >
Text File  |  1995-04-30  |  10KB  |  229 lines
  1. ----------------------
  2. Anleitung zu sWAV v0.2
  3. ----------------------
  4.  
  5.  
  6. Was sWAV kann
  7. -------------
  8. sWAV spielt Soundsamples im Wave-Format (.WAV) ab.
  9.  
  10. Besonderheiten:
  11. - Die  Länge  der  Samples kann beliebig groß sein, ist also nicht durch das 
  12.  verfügbare RAM begenzt.
  13. - sWAV  benutzt  die DMA-Soundhardware (8 Bit stereo), funktioniert also nur 
  14.  auf 1040 STE, Mega STE, TT und Falcon
  15. - sWAV versteht 8-Bit- und 16-Bit-Samples, mono und stereo.
  16. - sWAV unterstützt den MCRW-Cookie.
  17. - Beim  Aufruf  können  beliebig  viele Dateien und/oder Wildcards übergeben 
  18.  werden.
  19.  
  20. Was sWAV (noch) nicht bietet
  21. ----------------------------
  22. - Ausgabe per Soundchip (PSG)
  23. - Andere Dateiformate als WAVE
  24. - Kaffee kochen, Socken stopfen
  25.  
  26.  
  27. Wer sWAV geschrieben hat
  28. ------------------------
  29. (c) 1994/95 by 
  30.   Christoph Bartholme
  31.   Ettlinger Straße 37
  32.   D-76137 Karlsruhe
  33.   EMail: Christoph Bartholme @ KA2
  34.  
  35. Die Anwendung erfolgt auf eigene Gefahr. 
  36. Der Autor lehnt jegliche Verantwortung für irgendwelche Schäden an Hard- und 
  37. Software, Körper und Seele des Benutzers ab.
  38.  
  39.  
  40. Was sWAV kostet
  41. ---------------
  42. Nichts, außer ein paar kBytes Platz auf Ihrer Festplatte oder einer Arbeits- 
  43. diskette. :-)
  44.  
  45. sWAV ist Freeware.
  46. Die  Weitergabe  ist  erlaubt  unter  der  Bedingung,  daß  SWAV.TXT  (diese 
  47. Anleitung) unverändert und komplett mitkopiert wird.
  48.  
  49.  
  50. Wie sWAV bedient wird
  51. ---------------------
  52. sWAV  ist  eine simple TTP-Anwendung, der beim eine oder mehrere Dateien und 
  53. einige Parameter übergeben werden können.
  54.  
  55. Aufruf: swav [Parameter] Datei...
  56.  
  57. Parameter: (# = numerischer Wert; Eselsbrücken in Klammern)
  58. -H  : (help) Nur Anzeige eines Hilfetexts
  59. -I  : (info) Nur Anzeige einiger Werte des Samples; kein Abspielen
  60. -S  : (silent) Nur Abspielen des Samples; keine Anzeige
  61. -C  : (complete) Sample sofort komplett einlesen und dann abspielen
  62. -Z  : Sample  zufallig auswählen; hierzu müssen die Sampledateien, aus denen 
  63.       ausgewählt werden soll, per Wildcard oder Ordnername angegeben werden.
  64. -F# : (frequency) Abspielfrequenz festlegen; 
  65.      mögliche Werte für #: 0 :  6258 Hz
  66.                            1 : 12517 Hz
  67.                            2 : 25033 Hz
  68.                            3 : 50066 Hz
  69.      Ohne  diese  Option  wählt sWAV automatisch die passende (nächsthöhere) 
  70.      Rate.
  71. -A  : (adapt)  Sample  an Ausgaberate anpassen; damit wird das Sample in der 
  72.      korrekten Geschwindigkeit (und damit Tonhöhe) wiedergegeben.
  73. -O  : (loop) Sample endlos wiederholen, bis per Taste abgebrochen.
  74. -K# : (keys) Tastatursteuerung:  1 = an (default), 0 = aus
  75. -M# : (memory)  Länge  des  Blocks  in  zehntel  Sekunden,  den sWAV von der 
  76.      Sampledatei auf einmal einliest; Voreinstellung: 0.5 s.
  77. -V# : (volume) Lautstärke
  78.      mögliche Werte für #: 0 bis 40 entsprechend -80 dB bis 0 dB
  79. -L# : (left) Linker Kanal
  80.      mögliche Werte für #: 0 bis 20 entsprechend -40 dB bis 0 dB
  81. -R# : (right) Rechter Kanal
  82.      mögliche Werte für #: 0 bis 20 entsprechend -40 dB bis 0 dB
  83. -B# : (bass) Baßeinstellung
  84.      mögliche Werte für #: 0 bis 12 entsprechend -6 dB bis +6 dB
  85. -T# : (treble) Höheneinstellung
  86.      mögliche Werte für #: 0 bis 12 entsprechend -6 dB bis +6 dB
  87. -X#: internen Lautsprecher ein- oder ausschalten 1 = ein, 0 = aus
  88.      (nur bei TT und Falcon)
  89.  
  90. Die Parameter können auch direkt hintereinander geschrieben werden.
  91. Ein Beispiel: "-V40 -B10 -S" entspricht "-V40B10S"
  92.  
  93. Die Groß/Kleinschreibung ist unwesentlich.
  94.  
  95. Alle  Parameter können außerdem in der Environmentvariablen "swav" definiert 
  96. werden,  die  beim Programmstart eingelesen wird. Damit können Sie etwa auch 
  97. dann  Parameter  setzen,  wenn  Sie  sWAV im Desktop als Anwendung auf *.WAV 
  98. angemeldet haben und durch Doppelklick auf eine Wave-Datei starten.
  99.  
  100. sWAV  versteht Wildcards. Mit "C:\SAMPLES\*.WAV" etwa werden alle WAVE-Files 
  101. aus  dem  Ordner SAMPLES gespielt, mit "C:\SAMPLES\S*.WAV" alle, die mit "S" 
  102. beginnen.
  103.  
  104. sWAV  unterstützt  das ARGV-Protokoll. Wenn Ihre Shell bzw. Ihr Desktop dies 
  105. ebenfalls  unterstützt,  können beliebig viele Dateien übergeben werden, die 
  106. dann  der  Reihe  nach  abgespielt  werden.  Um  ein  komplettes Verzeichnis 
  107. abzuspielen, genügt es, das Ordnericon auf das Programmicon zu ziehen.
  108.  
  109. Wenn  in  der  selben  Verzeichnisebene eine Datei namens SWAV.INF vorhanden 
  110. ist,  wertet sWAV diese aus. In SWAV.INF können in mehreren Zeilen sämtliche 
  111. Parameter sowie die abzuspielenden Samples definiert werden. Zeilen, die mit 
  112. "*"  beginnen,  werden  als Kommentar gelesen und ignoriert. Die Gesamtlänge 
  113. aller  Parameter  und  Pfade dieser Datei darf höchstens 256 Byte, abzüglich 
  114. ein   Byte   pro  Zeile,  betragen.  Das  sollte  aber  normalerweise  immer 
  115. ausreichen.
  116.  
  117. Die  Lautstärken-  und Klangparameter werden bei Existieren des Cookies MCRW 
  118. von  diesem  übernommen,  ggf.  entsprechend  den  Optionen V, L, R, B und T 
  119. eingestellt   und  nach  Abspielen  des  Samples wieder auf die Anfangswerte 
  120. zurückgesetzt.
  121. Es  empfiehlt sich hierfür, im Kontrollfeld zur Soundeinstellung anstatt des 
  122. originalen  Moduls  SOUND.CPX  das  erweiterte  Modul  MCRW_SND.CPX von John 
  123. McLoud zu installieren, welches den MCRW-Cookie setzt und verwendet.
  124.  
  125. Mit  den  Sondertasten  läßt  sich  der Ablauf steuern (sofern die Tastatur- 
  126. steuerung nicht mit Option K0 abgeschaltet ist):
  127. - Shift links: aktuellen Block wiederholen; die Abspielroutine "hängt" also, 
  128.   solange die Taste gedrückt bleibt.
  129. - Alternate: Rücklauf
  130. - Alternate + Shift links: zum Anfang
  131. - Control: Schneller Vorlauf
  132. - Control + Shift links: zum  Ende;  es wird das nächste Samplefile begonnen 
  133.  bzw. das Programm beendet
  134. - Control + Alternate + Shift links: Programmabbruch
  135.  
  136.  
  137. Wie man sWAV am besten einsetzt
  138. -------------------------------
  139. Für  die  kontinuierliche Wiedergabe muß sich die zu lesende Datei auf einem 
  140. ausreichend  schnellen  Massenspeicher  befinden.  Also auf einer Festplatte 
  141. oder  einem  CD-ROM.  Bei  Diskettenbetrieb  sollten  Sie stets die Option C 
  142. verwenden.
  143. Manche   Festplatten   sind   regelmäßig  kurze  Zeit  mit  Rekalibrierungen 
  144. beschäftigt  und  wärend  dieser Zeit nicht ansprechbar. Das könnte Probleme 
  145. geben. Vermutlich hilft es, wenn Sie die Blocklänge heraufsetzen.
  146.  
  147. 16-Bit-Samples   werden  von  sWAF  ins  8-Bit-Format  konvertiert,  da  die 
  148. DMA-Hardware  ja  nur  8-Bit-Samples  abspielen  kann.  Dabei geht natürlich 
  149. einiges an Dynamik verloren. Aber besser so als gar nicht...
  150.  
  151. Wenn  in  einer  Multitaskingumgebung  parallel  zu  sWAV ein anderer Prozeß 
  152. läuft,  der  ebenfalls auf einen Massenspeicher zugreift, kann es passieren, 
  153. daß  es  sWAV  nicht  gelingt,  einen  neuen  Block  des Samples rechtzeitig 
  154. einzulesen  (Vor  allem, wenn beide vom CD-ROM lesen wollen). Das merken Sie 
  155. daran,  daß  sWAV  kurzzeitig "hängt" (wie eine Schallplatte). Dagegentreten 
  156. hilft   nichts.   Sie   können  jedoch  mit  der  Option  M  die  Blocklänge 
  157. beeinflussen.  Oder,  wenn  der  Sample komplett ins freie RAM paßt, ihn mit 
  158. Option C in einem Rutsch lesen lassen.
  159.  
  160. Die  Anpassung  der  Ausgaberate an die Aufnahmerate (Option A) kostet etwas 
  161. Rechenzeit  und  Klangqualität.  Wozu überhaupt eine Anpassung? Wave-Samples 
  162. für  Windows  sind  üblicherweise  mit  11025  Hz,  22050  Hz  oder 44100 Hz 
  163. aufgenommen,  die  Atari-Hardware  kann dagegen nur in den festen Frequenzen 
  164. 6258  Hz,  12517 Hz, 25033 Hz und 50066 Hz wiedergeben. Das Sample wird also 
  165. etwa  14% zu schnell abgespielt, was deutlich zu hören ist. Mit der Option A 
  166. wird  das  Sample  durch Einfügen zusätzlicher Werte "gestreckt" und dadurch 
  167. mit richtiger Geschwindigkeit wiedergegeben.
  168.  
  169. Vorsicht:
  170. Bei älteren Versionen von VT52.PRG, welches Mag!C beiliegt, funktioniert die 
  171. Tastaturabfrage  fehlerhaft;  etwa  bei  der  Version  mit 36340 Byte Länge. 
  172. Daher sollte hiermit unbedingt die Tastatursteuerung von sWAV mit der Option 
  173. K0  abgeschaltet  werden;  am  einfachsten  durch  Einfügen der Zeile "#_ENV 
  174. swav=-k0"  in  MAGX.INF.  Oder besser: Besorgen sie sich eine neuere Version 
  175. von VT52.PRG.
  176.  
  177.  
  178. Was sWAV im AUTO-Ordner treibt
  179. -----